home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 3 / BBS in a box - Trilogy III.iso / Files / Tele / A / AOL DM Assist / AOL DM Assist.README < prev    next >
Encoding:
Text File  |  1993-01-10  |  10.7 KB  |  158 lines  |  [TEXT/AOqc]
  1. America Online Download Manager Assistant (AOL DM Assist) 1.0b4
  2. ©1992,1993 Dave Martin (America Online ©1992, America Online, Inc.)
  3. 5101 Leonard Road #77
  4. Bryan, Texas 77803
  5.  
  6. January 10, 1993 — 1.0b4
  7.  
  8. This is the fourth beta version of AOL DM Assist, an unofficial External Tool for use with the America Online 2.0 software for the Mac. AOL DM Assist is a tool which provides many features lacking in the new Download Manager. It does not replace DM, it enhances it & complements it. Many of these features are ones that I hope to see AOL add to the Download Manager in later releases of the File Transfer Tool (though I now appreciate the work which would be involved in getting these in there). Until then, I've created this. It does not modify, in any way, the America Online program or any of its Tools. The only AOL-related file which this program affects is the Mailbox files (as selected by the user). I have checked with both a member of AOL's Mac Development team and with the TOS Advisor and have been told that there should be no problem distributing this (I wanted to be certain since I knew that they would not allow Andrew Welch's AOL Aid INIT to be distributed online - since this app doesn't affect the operation of the AOL software, it's ok).
  9.  
  10. It is important when using AOL DM Assist to remember to ALWAYS work with a COPY of your mail file, especially with the pre-final versions. AOL DM Assist opens the resource file to read in the DM data, then closes the file again. It does not open it again until it saves changes. This should reduce the chances of file corruption, but it does not guarantee it. If an error should occur while writing the file (or possibly even when reading the file), the odds are against the file surviving. While it is not impossible to use this utility while AOL 2.0 is running – online or off – it is strongly discouraged. AOL 2.0 does seem to follow the same routine with the resource file as I do (open only when reading or writing), but since the file holds both the download queue data and any incoming or outgoing mail messages, it would be advised to not try this. I have looked for, but have not yet found, a way to check the other processes and automatically exit if AOL 2.0 is running (at least, a way which works under System 6.x).
  11.  
  12. This utility has been tested on a Mac IIsi / System 7.0.1 + Tuner 1.1.1 / 32-bit Add ON with tons of extensions active during the development (best way to crash-test!) in addition to the systems used by my four alphans and the dozen or so betas (thanks, guys!). Since the files being opened are owned by AOL 2.0, AOL DM Assist does support drag-and-drop opening under System 7.x, though it should run without any problems under 6.x.
  13.  
  14. If you have any problems or bug reports, please direct them to me (with system config info). This is my first attempt at Macintosh (and Pascal) programming, so I can't certify that I'll know where to begin to correct the reported problems, but I'll do what I can.
  15.  
  16. Dave Martin (DBM)
  17. -----------------------------------------------------------------------
  18. Current working features are:
  19.  
  20. •  Opens the selected AOL Mail file, and reads in the Download 
  21.    Manager queue data. There are two queues that DM uses — the list 
  22.    of files left to download (including those partially transferred) 
  23.    and the list of files which have been completed. AOL DM Assist 
  24.    adds a third queue, which does not interfere with the other 
  25.    queues — a holding queue, for setting aside files which you don't 
  26.    wish to download at this time, but do want to keep handy for when
  27.    you are ready to transfer them.
  28.  
  29. •  You can shift queue entries up or down the list (multiple, 
  30.    discontinuous selections supported, including Select All).
  31.  
  32. •  Move entries to the Holding Queue for later downloading, and back
  33.    again into the Download Queue. Again, this works with multiple
  34.    selections.
  35.  
  36. •  Delete individual (or multiple, discontinuous -- or had you guessed
  37.    that part already ;) entries. Provides quick & easy clean-up of the
  38.    completed download list — just Select All and then delete.
  39.  
  40. •  You can do a Get Info on an individual entry for more details (file
  41.    size, location of partial file, etc.). You can edit the local
  42.    filename for a partially or completely downloaded file, and the
  43.    file types/creators.
  44.     *Note that changing the local name of a file or its type/creator 
  45.      will force a save of all changes made to the queues.
  46.  
  47. •  Rename the local filename of an entry.
  48.     *Note that changing the local name of a file will force a
  49.      save of all changes made to the queues.
  50.  
  51. •  Set Preferences via a dialog within the utility. Prefs currently
  52.    include whether to show the About box at launch, whether to prompt
  53.    for a file to open at launch, and whether to calculate estimated
  54.    download times based on 1200, 2400 or 9600 baud. Settings are saved
  55.    within the app's resource fork and can also be edited with the
  56.    provided ResEdit TMPL ('PreF').
  57. -----------------------------------------------------------------------
  58. Planned features:
  59.  
  60. •  I am considering writing my own list definition procedure ('LDEF')
  61.    to improve the list interface and add the ability to place 'SICN's
  62.    beside each entry to graphically indicate the file's download state
  63.    (complete, partial, not).
  64.  
  65. •  Allow setting of the default download folder (and optionally move
  66.    any partially-transferred files from the old folder to the new).
  67.  
  68. •  Let the user reset a partially downloaded file to zero. This would
  69.    delete the partial file and set the queue information for that
  70.    entry to indicate that the file has not been transferred at all.
  71.    This would fix files which are cancelled before the File Manager
  72.    creates the file - AOL's DM insists the file exists and chokes
  73.    when it can't locate it.
  74.  
  75. •  Ability to move a partial file to a new location (and update its 
  76.    queue entry), or reattach a Finder-relocated partial file with its
  77.    entry. This would be useful if you are forced (due to hard drive or
  78.    similar problems) or choose to relocate your downloads to a
  79.    different drive – if the DM can't find the volume/folder that the
  80.    partial file was originally downloaded to, it won't be able to
  81.    continue the transfer.
  82. -----------------------------------------------------------------------
  83. Known Problems:
  84.  
  85. •  The Close menu item is disabled, since on occasion the program 
  86.    will crash if you close a file then open another file. It seems to 
  87.    be a memory-related problem, which I'm looking in to. Even when 
  88.    enabled, though, the Close menu item is dimmed (though it is 
  89.    selectable) — I have yet to find an explanation for that, unless it 
  90.    is related to the fact that the windows do not have close boxes 
  91.    (it's easier -- for me, at any rate -- to manage three windows
  92.    which contain lists that are guaranteed to always be open than to
  93.    allow them to be closed).
  94. -----------------------------------------------------------------------
  95. America Online Download Manager Assistant is free, though you may send
  96. cash if you feel it has saved you from headaches that the DM alone would have caused -- I promise I won't stop you <grin>. At most, all I ask is that you beg AOL (Customer Support or even Steve Case ;) to include the functionality of this utility in the DM, so that the AOL software will be even better!
  97. I am considering writing a similar "External Tool" for improving the mail interface of AOL -- better address lists, multiple "folders" for
  98. filing incoming messages based on subject/source/etc., easier message
  99. deletion, and so forth. This presumes that AOL does not make such improvements themselves in the near future. If there is something that you would like to see as far as improvements to AOL's mail or download
  100. interface, let me know and I'll consider them.
  101. Thanks to those few (about two, right now) who have emailed me with
  102. comments about this utility -- I hope that the other 400+ people who
  103. downloaded it find it as useful.
  104. -----------------------------------------------------------------------
  105. VERSION HISTORY:
  106.  
  107. Changes in 1.0b4 (01/10/93):
  108.   * Added support for estimated time calculations based on 9600 baud.
  109.     The preferences resource ('PreF', ID=128) is now set up as below:
  110.       (TRUE=1, FALSE=0)
  111.       - PrefdoAbout:    TRUE = Show About box at application launch.
  112.                         FALSE= Don't show About box at launch.
  113.       - PrefdoOpen:     TRUE = Request file to open at launch.
  114.                         FALSE= Don't do SFStdGetFile at launch.
  115.       - PrefBaudLoHigh: TRUE = Calc Est. Time @ 2400/9600 baud (below)
  116.                         FALSE= Calc Est. Time @ 1200 baud
  117.       - PrefBaudHi2496: TRUE = Calc Est. Time @ 9600 baud
  118.                         FALSE= Calc Est. Time @ 2400 baud
  119.   * Added in 'dctb' resources to add color to dialogs.
  120.  
  121. Changes in 1.0b3 (08/92):
  122.   * Fixed problems with the auto save when using the Rename command.
  123.   * Modified code to use some OOP.
  124.   * Added the Preferences dialog for editing the 'PreF' settings.
  125.   * Moved the TMPLs for the 'FilQ' resource to a separate file.
  126.  
  127. Changes in 1.0b2:
  128.   * Modified the code to improve dialog management.
  129.  
  130. Changes in 1.0b1 (from 1.0a2 alpha version):
  131.   * Rearranged menu items, marked those which are planned with a green
  132.     bullet. While these were marked before, the bullet had been part
  133.     of the menu item name, rather than as a checkmark character.
  134.   * Added two menu items to the Download List menu: '1200 Baud' and
  135.     '2400 Baud'. This allows you to select the baud rate that is used
  136.     to estimate the time remaining for an untransferred or partially-
  137.     transferred file. (The estimated time was added to the listings in
  138.     1.0a2, but it was not clearly indicated and was based on 2400 baud.
  139.     The ETR is now in the form 'x.x min', and changes depending on the
  140.     setting. When AOL implements 9600 baud, I will add that option).
  141.   * Added a preferences resource to the utility ('PreF', ID=128) with
  142.     a ResEdit TMPL for editing it. At the moment, there are three 
  143.     prefs, each a boolean (0=false, 1=true) to indicate what the 
  144.     program will do:
  145.       - PrefdoAbout: TRUE = show About box at application launch.
  146.       - PrefdoOpen: TRUE = request file to open at launch.
  147.       - PrefBaud2400: TRUE = calc ETR @ 2400 baud, FALSE = calc @ 1200.
  148.     Eventually I will add in the ability to set the Prefs from within
  149.     the app, as well as remembering whether you have the 1200 or 2400
  150.     baud menu item checked.
  151.   * I now check to see if the WaitNextEvent trap is available and use
  152.     it if it's there, only using GetNextEvent if WNE is not present. I
  153.     currently have the idle at 60 ticks, so let me know if it's not
  154.     giving enough time to background processes, or not getting enough
  155.     for itself.
  156.   * Added the Rename command and the ability to change the name by
  157.     editing the local filename in the Get Info window.
  158.